package com.youlai.boot.modules.game.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.youlai.boot.modules.game.model.entity.GameAchievement;
import com.youlai.boot.modules.game.model.vo.GameAchievementVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 游戏成就Mapper接口
 *
 * @author 有来技术团队
 */
@Mapper
public interface GameAchievementMapper extends BaseMapper<GameAchievement> {

    /**
     * 获取用户解锁的成就列表
     *
     * @param userId 用户ID
     * @return 成就列表
     */
    List<GameAchievementVO> getUserAchievements(@Param("userId") Long userId);

    /**
     * 获取用户特定游戏的成就列表
     *
     * @param userId 用户ID
     * @param gameId 游戏ID
     * @return 成就列表
     */
    List<GameAchievementVO> getGameAchievements(@Param("userId") Long userId, @Param("gameId") Long gameId);

    /**
     * 获取可以解锁的成就列表
     *
     * @param userId 用户ID
     * @param conditionType 条件类型
     * @param conditionValue 条件值
     * @return 可解锁的成就列表
     */
    List<GameAchievement> getUnlockableAchievements(
            @Param("userId") Long userId,
            @Param("conditionType") String conditionType,
            @Param("conditionValue") Integer conditionValue
    );
} 